Mouse scroll

UiPath.UIAutomationNext.Activities.NMouseScroll

Description

Permet de faire défiler les applications en envoyant des événements de défilement de la souris à l’élément d’IU spécifié.

Cette activité ne peut pas être ajoutée dans une activité Use Application/Browser.

Cette activité est compatible avec le référentiel d’objets.

Remarque :

Si aucune cible n'est fournie pour cette activité, elle utilise automatiquement la cible de l'étendue dans laquelle elle est incluse.

De plus, en raison de la nature de cette activité, elle ne peut pas être utilisée en arrière-plan.

Pour plus d'informations sur l'indication et la configuration des cibles, consultez Écran de sélection.

Compatibilité du projet

Windows - Héritage | Windows | Multiplateforme

Windows - Héritage, configuration Windows

Module Designer

• Sélectionnez le menu pour accéder aux options suivantes :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.
  • Supprimer la capture d'écran d'information (Remove informative screenshot ) - Supprime la capture d'écran de l'application cible ou de la page Web.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.

• Direction (Direction) - Direction dans laquelle vous souhaitez que le défilement soit effectué. Les options suivantes sont disponibles : Gauche, Haut, Droite, Bas. L'option par défaut est Bas ( Down).

• Type de défilement : choisissez entre les deux méthodes d'utilisation pour cette activité :

  • À l'élément (To element ) : défile jusqu'à ce qu'un élément d'IU spécifié soit trouvé dans l'application cible. Il s'agit de l'option par défaut.

    Remarque : si vous sélectionnez Élément To (To) dans le champ Type de défilement, le champ de propriété Nombre de défilements est ignoré et l'élément d'IU spécifié est recherché.

    Si, au moment de l'exécution, l'élément indiqué est introuvable, l'activité défile autant que spécifié dans le champ # of scrolls , puis relance la recherche de l'élément indiqué. Ce comportement est répété autant de fois que nécessaire, jusqu'à ce que l'élément soit trouvé, et peut être utile dans le cas d'applications qui ont des temps de chargement plus longs.

  • Distance - Défile uniquement autant que spécifié dans le champ de propriété Nombre de défilements .

    Remarque : le nombre de lignes parcourues par un mouvement de défilement est configuré dans la section Paramètres de la souris (Mouse settings) de Windows. En cas de défilement vers un élément spécifique, l'élément est recherché une fois toutes les rotations exécutées. La sélection de cette méthode affiche également la propriété # of scrolls dans le corps de l’activité.

• Faire défiler jusqu'à l'élément (Show to element ) : cliquez sur Indiquer dans l'application/le navigateur (Indicate in App/Browser) pour indiquer l'élément d'IU jusqu'à lequel vous souhaitez faire défiler. Cette option apparaît uniquement si l'élément À (To) est sélectionné dans le menu déroulant Type de défilement .

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

• Délai après : délai (en secondes) entre le moment où cette activité est terminée et le moment où l'activité suivante commence toutes les opérations. La valeur par défaut est de 0,3 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur. Un nom d'affichage est automatiquement généré lorsque vous indiquez une cible.

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

  Attention : Si vous faites défiler jusqu'à une cible d'image, il est recommandé d'augmenter la valeur de la propriété Délai d'attente pour tenir compte des temps de recherche d'image plus longs.

Entrée

• TypeMouvementCurseur : spécifie le type de mouvement effectué par le curseur de la souris. Deux options sont disponibles :

  • Instantané : le curseur passe à la destination. Il s'agit de l'option par défaut.
  • Lisse : le curseur se déplace par incréments. Le paramètre n'a d'effet que si le mode d'entrée Événements matériels est utilisé.
• Cible (Target) - L'élément cible. L’élément cible doit être défini. Avant d'être indiqué à l'écran, ce champ est défini sur (null). Une fois la cible indiquée, toutes les propriétés concernant l'élément qui a été indiqué sont affichées.
  • Décalage duclic : spécifie un décalage pour l'activité de clic, qui peut être configuré davantage.
    • Point d'ancrage - Décrit le point de départ du curseur auquel les décalages des propriétés Décalage X et Décalage Y sont ajoutés. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRightet Center. Par défaut, Center est sélectionné.
    • Décalage X - Déplacement horizontal de la position du curseur en fonction de l'option sélectionnée dans le champ Point d'ancrage . Ce champ prend uniquement en charge les variables Int32 .
    • Décalage Y - Déplacement vertical de la position du curseur en fonction de l'option sélectionnée dans le champ Point d'ancrage . Ce champ prend uniquement en charge les variables Int32 .
  • Type decontrôle CV (CV Control type ) : indique le type de contrôle identifié à l'aide de Computer Vision.
  • Texte CV - Indique le texte identifié à l’aide de Computer Vision.
  • Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives.
  • Texte natif : le texte utilisé pour identifier l'élément d'IU.
  • Sites Web réactifs - Activez la mise en page des sites Web réactifs.
  • Sélecteur strict : le sélecteur strict généré pour l'élément d'IU.
  • Méthodes de ciblage : les types de sélecteurs à utiliser pour identifier l'élément. Cette propriété peut recevoir n'importe quelle combinaison à partir du menu déroulant :
    • Aucun (None)
    • Sélecteur strict
    • Sélecteur de correspondances approximatives
    • Image
    • Texte natif
    • Computer Vision
  • Contrôle de visibilité (Visibility check ) - Vérifie si l'élément d'IU est visible ou non. Vous pouvez choisir l’une des trois options suivantes dans le menu déroulant :
    • Aucun : ne vérifie pas la visibilité.
    • Interactif (pour le Sélecteur de correspondances approximatives) : option par défaut. Vérifie si l'élément est potentiellement visible, en ignorant le défilement de la page et les obstructions par d'autres applications, ou le fait que l'application est réduite. Cette vérification est utile lorsque vous essayez de vous assurer que vous ne ciblez pas des éléments invisibles qui existent dans le DOM mais qui sont masqués.
    • Entièrement visible : vérifie si l'élément d'IU est visible ou non.
  • Attendre le chargement de la page : avant d'effectuer les Actions, attendez que l'application soit prête à accepter les entrées. Vous pouvez choisir l’une des trois options suivantes dans le menu déroulant :
    • None : n’attend pas que la cible soit prête.
    • Interactif : attend qu'une partie de l'application soit prête.
    • Complète  : attend que l'application entière soit prête.
  • Sélecteur de fenêtre (Instance d'application) : le sélecteur utilisé pour la fenêtre d'application. Uniquement applicable lorsque le mode d'attachement de fenêtre est défini sur Instance d'application (Application instance).

Élément d’entrée/de sortie

• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.

Divers

• Privé (Private) : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose). Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

Options

• Nombre de défilements : le nombre de défilements à effectuer, stocké dans une variable Int32 . Si le type de défilement dans le corps de l' activité est défini sur élément À ( To element) , ce champ est défini par défaut sur 10. Si cette option est définie sur Distance, ce champ est défini sur 5 par défaut.
• Direction : voir Direction dans le panneau Concepteur.

• Mode d'entrée (Input mode ) : sélectionnez la méthode que le Robot doit utiliser pour interagir avec l'application cible :

  • Identique à l'application/au navigateur (Identique à l'application/au navigateur ) - Utilisez le même mode d'entrée que l'activité Utiliser l'application/le navigateur .

  • Événements matériels (Hardware Events ) : utilise le pilote matériel pour effectuer l'action. C'est la méthode la plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.

  • ChromiumAPI - Effectue des actions grâce aux API de débogage. Fonctionne uniquement avec les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l'application cible nest pas au point. Pour plus de détails, consultez cette page.

• Modificateurs de touche (Key modifiers ) : ajoutez un ou plusieurs modificateurs de touche à utiliser en combinaison avec les Actions de l'activité. Les options suivantes sont disponibles : Aucun, Alt, Ctrl, Majet Win. L'option par défaut est Aucun ( None).

• Élément recherché (Searched element ) : l'élément de l'interface utilisateur indiqué vers lequel vous souhaitez faire défiler.

  • Élément de sortie (Output element ) : la référence de l'élément de l'interface utilisateur recherché, que vous pouvez utiliser dans d'autres activités d'UI Automation, dans la propriété Élément d'entrée ( Input Element ).
  • Cible (Target) : cet élément d’IU a sa propre propriété Cible (Target ) qui peut être configurée de la même manière que la propriété principale.
  • Délai d'attente (Timeout) : durée (en secondes) d’attente pour que l’élément recherché apparaisse. La valeur par défaut est 0,2 seconde.

Configuration multiplateforme

• Étendue du travail (Work in scope ) - Choisissez l'onglet du navigateur générant le rendu de l'application Web à automatiser.
• Faire défiler le conteneur : fait défiler toute la page ou l'intérieur d'un élément. L'option par défaut est Page entière ( Entire page).
• Direction dedéfilement : la direction dans laquelle vous souhaitez que le défilement soit effectué. Les options suivantes sont disponibles : Gauche, Haut, Droite, Bas. L'option par défaut est Bas ( Down).
• Type de défilement : choisissez entre les deux méthodes d'utilisation pour cette activité :
  • À l'élément (To element ) : défile jusqu'à ce qu'un élément d'IU spécifié soit trouvé dans l'application cible. Il s'agit de l'option par défaut.
  • Distance - Défile uniquement autant que spécifié dans le champ de propriété Nombre de défilements .

• Indiquer l'élément recherché à l'écran (Indicate searched element on screen ) : indiquez l'élément d'IU vers lequel vous souhaitez faire défiler. Cette option apparaît uniquement si l'élément À (To) est sélectionné dans le menu déroulant Type de défilement .

  Après avoir indiqué la cible, sélectionnez le bouton Plus pour accéder aux options suivantes :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.

• Nombre de défilements : le nombre de défilements. Cette option apparaît uniquement si l'option Distance est sélectionnée dans le menu déroulant Type de défilement .

Options supplémentaires

Horaires

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai après : délai (en secondes) entre le moment où cette activité est terminée et le moment où l'activité suivante commence toutes les opérations. La valeur par défaut est de 0,3 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

• Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

Entrée/sortie

• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.
• Élément de sortie recherché : la référence de l'élément de l'interface utilisateur recherché, à utiliser dans d'autres activités en tant qu'élément de l'interface utilisateur d'entrée. Cette option apparaît uniquement si l'élément À (To) est sélectionné dans le menu déroulant Type de défilement .